Description of Keys & Commands
==============================
Note: English translation still under construction!

Command-Group "DAT": Datum/Zeit
===============================

Die Gruppe der DAT-Commands sendet Datum und Zeit in unterschiedlichen Formaten.
Im "Store"-Profil befinden sich zahlreiche Knpfe, die das Datum in unter-
schiedlicher Form ausgeben.


/DAT.>.MEM ............: To copy date into RK-DateMemory
/DAT.CW ...............: Calendar week
/DAT.DATE1 ............: Date, short format (15.05.2002)
/DAT.DATE2 ............: Date, medium format (15. Mai. 02)
/DAT.DATE3 ............: Date, long format (Mittwoch, 15. Mai 2002)
/DAT.DATE4 ............: Date, system default format (15.05.2002)
/DAT.DATE5 ............: Date, general format (15.05.2002 18:17:43)
/DAT.DATE1.ADD-D [v] ..: To send a calculated date, <+/- v> days in future/past (see description below)
/DAT.DATE1.ADD-M [v] ..: To send a calculated date, <+/- v> monthes in future/past
/DAT.DAY1 .............: Day (7, 27)
/DAT.DAY2 .............: Day, 2 digits always (07, 27)
/DAT.FORMAT str .......: Date/Time, formatted output (see description below)
/DAT.HOUR1 ............: Hour (2, 22)
/DAT.HOUR2 ............: Hour, 2 digits always (02, 22)
/DAT.MEM.DIF-D.>VAR ...: To set current VAR to the difference between current/temp-date and RK-DateMemory-date
/DAT.MINUTE1 ..........: Minute (6, 16)
/DAT.MINUTE2 ..........: Minute, 2 digits always (06, 16)
/DAT.MONTH-E ..........: Month name, english (May)
/DAT.MONTH-F ..........: Month name, french (Mars)
/DAT.MONTH-G ..........: Month name, german (Mai)
/DAT.MONTH-USER .......: Month name, user-defined
/DAT.MONTH-SYS ........: Month name, system default format
/DAT.MONTH-NO1 ........: Month as number (5, 12)
/DAT.MONTH-NO2 ........: Month as number, 2 digits always (05, 12)
/DAT.SECOND1 ..........: Second (4, 55)
/DAT.SECOND2 ..........: Second, 2 digits always (04, 55)
/DAT.STPWTCH.START ....: To start stopwatch
/DAT.STPWTCH.CONT .....: To continue stopwatch
/DAT.STPWTCH.STOP .....: To stop stopwatch and to show result
/DAT.TEMP.<.MEM .......: To set RK-temp-date to RK-DateMemory-date
/DAT.TEMP.ADD-D [v] ...: To add/sub <+/- v> days to RK-temp-date for DAT commands (not system date)(see descr. below)
/DAT.TEMP.ASK .........: To change RK-temp-date/ -time for DAT commands (not system date)
/DAT.TEMP.MEM.SWAP ....: To swap between RK-temp-date and RK-DateMemory-date
/DAT.TEMP.RESET .......: To reset RK-temp-date/ -time to current date
/DAT.TIME.AMPM1 .......: AM or PM, two letters in uppercase (PM)
/DAT.TIME.AMPM2 .......: AM or PM, two letters in lowercase (pm)
/DAT.TIME.AMPM3 .......: AM or PM, one letter  in uppercase (P)
/DAT.TIME.AMPM4 .......: AM or PM, one letter  in lowercase (p)
/DAT.TIME1 ............: Time, short format (18:22)
/DAT.TIME2 ............: Time, medium format (06:22)
/DAT.TIME3 ............: Time, long format (18:23:28)
/DAT.TIME4 ............: Time, system default format (22:13:12)
/DAT.TIME1.ADD-H [v] ..: To send a calculated time, <+/- v> hours in future/past
/DAT.TIME1.ADD-M [v] ..: To send a calculated time, <+/- v> minutes in future/past
/DAT.VIEW .............: To view current and RK-temp-date in the int. text viewer
/DAT.WDAY-E ...........: Weekday, english (Saturday)
/DAT.WDAY-F ...........: Weekday, french (Samedi)
/DAT.WDAY-G ...........: Weekday, german (Sonnabend)
/DAT.WDAY-USER ........: Weekday, user-defined
/DAT.WDAY-SYS .........: Weekday, system default format
/DAT.YEAR1 ............: Year (2001)
/DAT.YEAR2 ............: year, 2 digits only (01)

Man kann sich das Datumsformat durch Zusammenbau der Commands und Hinzufgen
von Zeichen (Punkte, Leerzeichen etc. )individuell zusammenstellen.

Example: {/DAT.DAY1}. {/DAT.MONTH-G} {/DAT.YEAR1}

Dieses Beispiel gibt den Text im folgenden Format aus: "18. August 2001".

Mit dem TEMP-Commands kann man das Datum und/oder die Zeit fr die DAT-Commands
neu setzen, ohne da dadurch das System-Datum des Computers gendert wird!
Diese Einstellung bleibt bis zum Programm-Ende erhalten, sofern es nicht
mit TEMP.RESET wieder auf das aktuelle Datum bzw. die aktuelle Zeit zurck-
gestellt wird oder durch erneuten Aufruf eines TEMP-Commands gendert wird.

Example: {/DAT.TEMP.ADD-D -1}

Nach diesem Command beziehen sich alle folgenden DAT-Commands auf den
vorherigen Tag.

Ab v8.1 wurde ein RK-DateMemory (Datum-Commands, die ein "MEM" beinhalten)
eingerichtet. Dadurch, da nun ein zweites Datum zur Verfgung steht, knnen
fortan auch Datums-Differenzen berechnet werden (/DAT.MEM.DIF-D.>VAR).
Der Ablauf gestaltet sich so, da das RK-Datum temporr gendert wird, dann
in das RK-DateMemory gespeichert wird und schlielich das RK-Datum neu gesetzt
oder auf das aktuelle Datum gesetzt wird.
Anschlieend ist eine Differenzberechnung mglich. Das Ergebnis wird in der
aktuellen VAR abgelegt und steht somit fr weitere Berechnungen zur Verfgung.

Example:

{/BTCH.EXPLICIT}
{/DAT.TEMP.ASK}
{/DAT.>.MEM}
{/DAT.TEMP.RESET}
{/DAT.MEM.DIF-D.>VAR}
{/VAR.VIEW}

--> Beachte
Wird das temporre Datum gesetzt, so entspricht DATE4 > DATE1 und TIME4 > TIME2.
Die sytembezogenen Commands fragen das Datum direkt ab und knnen nicht temporr
gendert werden. Daher werden die wahrscheinlichsten Entsprechungen eingesetzt.

--> Beachte
Statt durch den OK-Knopf kann das temporre Datum im ASK-Fenster auch durch einen
Doppelklick auf ein Datum gesetzt werden.

Mit Hilfe der o.g. USER-Commands knnen auch Abkrzungen und fremdsprachige
Ausdrcke gesendet werden, wie z.B. "Aug.".
Die Definitionen werden in der im Profiles-Ordner befindlichen "UserApp.dat"
vorgenommen.

Die o.g. systemvorgegebenen Formate knnen auf verschiedenen Rechner unter-
schiedlich aussehen, denn sie sind von den Einstellungen in den Lnderein-
stellungen der Windows-Systemsteuerung abhngig.


/DAT.DATE1.ADD-D [v] ..: To send a calculated date, <+/- v> days in future/past
/DAT.DATE1.ADD-M [v] ..: To send a calculated date, <+/- v> monthes in future/past
/DAT.TIME1.ADD-H [v] ..: To send a calculated time, <+/- v> hours in future/past
/DAT.TIME1.ADD-M [v] ..: To send a calculated time, <+/- v> minutes in future/past
------------------------

Example: {/DAT.DATE1.ADD-D 3} ...: adds 3 days to current date and sends calculated date
Example: {/DAT.TIME1.ADD-M -30} .: subs 30 minutes from current time and sends calculated time

Ab V8.0 kann anstelle eines festen Parameters die aktuelle VAR eingesetzt werden.
Fr diesen Zweck lt man den Parameter einfach weg.

Example:

{/BTCH.EXPLICIT}
{/VAR.ASK}
{/DAT.DATE1.ADD-D}


/DAT.FORMAT str .......: Date/Time, formatted output
------------------------
The output was generated on a german Windows system.

Parameter for "str":
--------------------

Stand alone parameters:

s/d ....: short date
m/d ....: medium date
l/d ....: long date
sys/d ..: system date
s/t ....: short time
m/t ....: medium time
l/t ....: long time
sys/t ..: system time
sys/dt .: system date & time
gen ....: system general date/time

Combination parameters:

Date (d=day, m=month, y=year):

d ......: 7
dd .....: 07
ddd ....: Di
dddd ...: Dienstag
ddddd ..: 07.05.2002 (= sys/d)
dddddd .: Dienstag, 7. Mai 2002
m ......: 6
mm .....: 06
mmm ....: Jun
mmmm ...: Juni
yy .....: 02
yyyy ...: 2002

Time (h=hour, m=minute, s=second, t=time):

h ......: 3
hh .....: 03
m ......: 8
mm .....: 08
s ......: 4
ss .....: 04
am/pm ..: am
AM/PM ..: AM
a/p ....: a
A/P ....: A
ttttt ..: 00:09:41 (= sys/t)

Separators:

/ ......: Converts to system separator (dd/mm/yy)
other ..: Any other separator possible (dd-mm-yy or dd.mm.yy or dd mm yy)

Example: {/DAT.FORMAT s/d}
Example: {/DAT.FORMAT dddd, dd. mmmm yyyy}
Example: {/DAT.FORMAT d-mmm}
Example: {/DAT.FORMAT h:mm:ss am/pm}
Example: {/DAT.FORMAT ddddd ttttt}
